.\"   $Id: allocrdsrecwin.3,v 1.1 2002/03/13 13:37:37 fred Exp $
.\" @(#)allocrdsrecwin.1 1.11 93/08/18 ; Labo masi cao-vlsi
.if t \{\
.so man1/alc_contents.mac
.XS \n%
.ti 0.2i
allocrdsrecwin
.XE
.XS0 \n%
.ti 0.2i
allocrdsrecwin
.XE0 \}
.TH ALLOCRDSRECWIN 3 "October 1, 1997" "ASIM/LIP6" "RDS PHYSICAL FUNCTIONS"
.SH NAME
allocrdsrecwin \- allocates a structure used to know windows which contains a rectangle. 
.so man1/alc_origin.1
.SH SYNOPSIS
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include "rwinnn.h"
 rdsrecwin_list \(**allocrdsrecwin()
.ft R
.fi
.SH PARAMETER
none
.SH DESCRIPTION
The \fIallocrdsrecwin\fP function allocates a rdsrecwin_list structure item. This structure contains a pointer to a window structure so it permits to chain all windows which contains a same rectangle (see librwi).
.SH RETURN VALUE
The pointer to the newly allocated structure is returned.
.SH ERRORS
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
"Rds202: rdsalloc error, can't continue !"
.ft R
.RS
it's impossible to allocate the memory size desired
.SH EXAMPLE
.ta 3n 6n 9n 12n 15n 18n 21n
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
        #include "mutnnn.h"
        #include "rdsnnn.h"
        #include "rwinnn.h"
        #include "rtlnnn.h"
        # define POINTER_WINDOW(R)                                \\
                                                                  \\
          (((UserStruct \(**)((char \(**)(R)+sizeof(rdsrec_list)))->WINDOW )
        typedef struct UserStruct
         {
           rdsrecwin_list \(**WINDOW;
         } UserStruct;
        main()
          {
             rdsfig_list \(**Figure;
             rdsrec_list \(**Rectangle;
             rdswin_list \(**Window;
             mbkenv();
             rdsenv();
             loadrdsparam();
             Figure = addrdsfig( "core",sizeof ( UserStruct ) );
             Rectangle =
               addrdsfigrec(Figure,"Alu1",RDS_ALU1,2,4,5,1);
             POINTER_WINDOW (Rectangle) = \fBallocrdsrecwin\fP();
             . . . .
             Window = ...
             (POINTER_WINDOW (Rectangle))->WINDOW = Window;
             . . . .
          }
.ft R
.fi
.SH SEE ALSO
.BR librwi


.so man1/alc_bug_report.1

